Skip to content

Conversation

@dongjoon-hyun
Copy link
Member

@dongjoon-hyun dongjoon-hyun commented Dec 6, 2025

What changes were proposed in this pull request?

This PR aims to promote RequiresDistributionAndOrdering and its required interfaces to Evolving from Experimental.

Why are the changes needed?

Since Apache Spark 3.2.0, RequiresDistributionAndOrdering and its required interfaces have been served stably over 5 years like the following. In Apache Spark 4.2.0, we had better promote this to Evolving because these are no longer Experimental.

Interface Description
org.apache.spark.sql.connector.distributions.ClusteredDistribution Unchange
org.apache.spark.sql.connector.distributions.Distribution Unchange
org.apache.spark.sql.connector.distributions.Distributions Unchange
org.apache.spark.sql.connector.distributions.OrderedDistribution Unchange
org.apache.spark.sql.connector.distributions.UnspecifiedDistribution Unchange
org.apache.spark.sql.connector.expressions.NullOrdering No Functional Change
org.apache.spark.sql.connector.expressions.SortDirection No Functional Change
org.apache.spark.sql.connector.expressions.SortOrder Stably Evolving
org.apache.spark.sql.connector.write.RequiresDistributionAndOrdering Stably Evolving

Does this PR introduce any user-facing change?

No.

How was this patch tested?

Pass the CIs and manual review.

Was this patch authored or co-authored using generative AI tooling?

No.

@github-actions github-actions bot added the SQL label Dec 6, 2025
@dongjoon-hyun
Copy link
Member Author

WDYT, @aokolnychyi , as the author of these interfaces?

@dongjoon-hyun
Copy link
Member Author

Gentle ping, @aokolnychyi .

@dongjoon-hyun
Copy link
Member Author

Could you review this PR, @peter-toth ?

Copy link
Contributor

@peter-toth peter-toth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @dongjoon-hyun for pinging me.

Yeah, these promotions make sense to me.

@dongjoon-hyun
Copy link
Member Author

Thank you so much for your review and approval, @peter-toth .

Merged to master for Apache Spark 4.2.0.

@dongjoon-hyun dongjoon-hyun deleted the SPARK-54622 branch December 7, 2025 19:03
xu20160924 pushed a commit to xu20160924/spark that referenced this pull request Dec 9, 2025
…required interfaces to `Evolving`

### What changes were proposed in this pull request?

This PR aims to promote `RequiresDistributionAndOrdering` and its required interfaces to `Evolving` from `Experimental`.

### Why are the changes needed?

Since Apache Spark 3.2.0, `RequiresDistributionAndOrdering` and its required interfaces have been served stably over 5 years like the following. In Apache Spark 4.2.0, we had better promote this to `Evolving` because these are no longer `Experimental`.
- apache#30706

| Interface | Description |
| - | - |
| org.apache.spark.sql.connector.distributions.ClusteredDistribution | Unchange |
| org.apache.spark.sql.connector.distributions.Distribution | Unchange |
| org.apache.spark.sql.connector.distributions.Distributions | Unchange |
| org.apache.spark.sql.connector.distributions.OrderedDistribution | Unchange |
| org.apache.spark.sql.connector.distributions.UnspecifiedDistribution | Unchange |
| org.apache.spark.sql.connector.expressions.NullOrdering | No Functional Change |
| org.apache.spark.sql.connector.expressions.SortDirection | No Functional Change |
| org.apache.spark.sql.connector.expressions.SortOrder | Stably Evolving |
| org.apache.spark.sql.connector.write.RequiresDistributionAndOrdering | Stably Evolving |

### Does this PR introduce _any_ user-facing change?

No.

### How was this patch tested?

Pass the CIs and manual review.

### Was this patch authored or co-authored using generative AI tooling?

No.

Closes apache#53361 from dongjoon-hyun/SPARK-54622.

Authored-by: Dongjoon Hyun <[email protected]>
Signed-off-by: Dongjoon Hyun <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants